home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / earcd / -archivi / -recent2 / ilbmdt44.lha / ilbmdt44 / ilbmdt44.doc < prev   
Text File  |  1999-03-11  |  8KB  |  169 lines
  1.            ilbm.datatype v44
  2.     © 1997-1999 by Stephan Rupprecht
  3.         All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  ilbm.datatype v44 is copyrighted 1997-99 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged. The author is not responsible for any damage 
  11.  caused by the use or misuse of this documentation and/or the 
  12.  program(s) it describes.
  13.  
  14.  PlanarToChunky routine © by Morten Eriksen.
  15.  
  16.  All mentioned trademarks are subject to their respective owners.
  17.  
  18.  
  19. REQUIREMENTS
  20.  - Any Amiga® (compatible) computer with at least OS3.0.
  21.  - 68020+ cpu
  22.  - any picture.datatype (v43 recommend, p96 version works 
  23.    without gfxboard)
  24.  
  25.  
  26. DESCRIPTION
  27.  ilbm.datatype v44 is a replacement for the original ilbmdt and allows
  28.  you to display ham and ehb pictures on a non-native (eg. p96/cgfx)
  29.  screen in correct colors. Even if you don't have a gfx-board you'll
  30.  be able to view 24bit iff images and ham8 images on ocs/ecs.
  31.  
  32.  
  33. INSTALLATION
  34.  Just 'Copy ilbm.datatype TO SYS:classes/datatypes/'.
  35.  
  36.  
  37. USAGE
  38.  There's no difference in using my ilbmdt and the original one. The
  39.  datatype automatically adapts itself to the underlying picture datatype.
  40.  You can configure the datatype by placing desired options in an environment
  41.  variable called 'datatypes/ilbmdt44.prefs'. Please use SetEnv (global)
  42.  or Set (local) to create the variable. To make the changes permanent, you
  43.  have to copy the variable from env to envarc.
  44.  
  45.  The preferences template is:
  46.  V42MODE/S,OLDDEC/T,CHIPBM/T
  47.  
  48.  V42MODE: switches the decoder into the v42 compatible mode even when 
  49.  pictdt v43 is installed. You should switch on this option if you don't have
  50.  a gfx-board but pictdt v43 installed.
  51.  
  52.  OLDDEC: Fixes the "corrupt image problem" when using ibrowse in conjuction
  53.  with the p96 pictdt (a few people have the same problem with the cgfx version
  54.  but I can't confirm it). This option switches the datatype into V42MODE for
  55.  images with <= 8bits (behaviour of v44.13 and earlier). Starting version 
  56.  43.40 of picture.datatype (p96) this problem is fixed. To gain maximum speed
  57.  OLDDEC should be turned on as it avoids some redundant planar<->chunky
  58.  conversion for images with 1..7 planes. Default for this option is YES. Use
  59.  OLDDEC=NO to switch it off.
  60.  
  61.  CHIPBM: Tells the datatype to allocate temporary bitmaps in chipmem instead 
  62.  of fastram. If you don't have a patch such as NewWPA8 installed (replaces
  63.  WritePixelArray8 of graphics.library by a faster one), setting this
  64.  option will avoid that garbage is produced when 24bit images are converted
  65.  to ham (also true for ham8 to ham6 conversion). There's no other reason to
  66.  switch on this option as it would slow down the conversion routines. This
  67.  option always changes the global setting! Starting 44.18 this option is
  68.  turned on by default when cgfx or p96 is installed, when there's no cgfx
  69.  compatible api available this option is turned off by default. NOTE: Also
  70.  starting 44.18 this option expects either a YES or NO!
  71.  
  72.  
  73. KNOWN PROBLEMS
  74.  - DOpus Mangellan and 24bit/ham images
  75.  According to the docs of DOpus 5.65, DOpus has some problems to
  76.  display 24bit images under certain circumstances. This is not a bug
  77.  of the datatype! (thanks to Dennis Barret for the error report)
  78.  pre 5.65 releases work fine.
  79.  - picture.datatype <= v42 (V42MODE) and 24bit images
  80.  If you get garbage instead of a 24bit image that was converted to ham,
  81.  you can either switch on the CHIPBM option of the datatype or install
  82.  a WritePixelArray8 patch such as NewWPA8 (faster solution).
  83.  - ilbmdt 44.14+, ibrowse and p96 pictdt <= v43.39
  84.  For unknown reasons the navigation buttons of ibrowse are corrupt when
  85.  using it in conjunction with the p96 pictdt. The OLDDEC option worksaround
  86.  this problem by switching the datatype into V42MODE for <= 8bit images.
  87.  
  88.  
  89. HISTORY
  90.  44.0 1st upload: first public release
  91.  44.1 a few optimiziations, skips masking planes now,
  92.        added KNOWN PROBLEMS section to the doc 
  93.  44.2 fixed a bug which made some programs (ex. MUI)
  94.       to display garbage when using a 24bit/ham image on
  95.       a screen deeper than 8bit.
  96.  44.3 bug fix: enforcer hit when library was expunged
  97.      (thanks to Magnus Holmgren for the error report)
  98.  44.4 bug fix: iff24 images with masking weren't correctly
  99.       decoded (thanks to Steve Cutting for the error report)
  100.  44.5 cleaned-up the code a little bit, special version which
  101.       supports planar to chunky hardware
  102.  44.6 removed p2c version (slower than normal one). supports 
  103.       b/w and greyscale pictures now (no cmap, mainly used by 
  104.       PageStream). Didn't set transparent color for images
  105.       with transparent masking (hope that is fixed now).
  106.  44.7 doesn't require cgfx/p96 and pictdtv43 any longer
  107.  44.8 aspect ratio wasn't set 
  108.  44.9 works with ProBench now
  109.  44.10 compiled with gcc (made some internal changes necessary),
  110.        datatype is now some bytes smaller and probably a bit faster
  111.        when decoding <= 8bit images.
  112.  44.11 broke decoding routine for images with masking last time.
  113.        Thanks to Jens Rosenboom for the bugreport.
  114.  44.12 broke something again :( This time the library function
  115.        table. Stupid me! Thanks to Gerald Schnabel for the bug
  116.        report.
  117.  44.13 by request of a single user, you can turn off the HAM to 24bit
  118.        conversion by setting an enviroment variable.
  119.  44.14 changed home directory of prefs variable. 24bit images will be
  120.        converted to HAM when pictdt v43 isn't available (or when V42MODE
  121.        switch is on). enhanced decoder to work in mode v43 even for <= 8bit
  122.        images (which also fixes the "transparent color problem"). 
  123.        added ham8 to ham6 conversion for ocs/ecs machines. supports NAME, 
  124.        ANNO, Copyright, AUTH and FVER chunks, now. optimized and bugfixed
  125.        library module.
  126.  44.15 fixed a harmless (?) bug in the iff scan routine. color palette for ham8
  127.        to ham6 conversion wasn't set up correctly due to a compiler bug. added
  128.        a new switch (CHIPBM) which tells the datatype to allocated temporary
  129.        bitmaps in chipmem instead of fastram (see docs/usage for more about it).
  130.        added OLDDEC option to workaround the "p96 pictdt / ibrowse" problem.
  131.  44.16 improved planar to chunky routine a bit. removed WriteChunkyPixels()
  132.        support for v40+ systems (slower than WritePixeLine8() without c2p
  133.        hardware) <Olaf Barthel>. v43.40 of picture.datatype (p96) fixes the
  134.        corrupt image problem, added a note concerning this to the doc.
  135.        OLDDEC option is now a (/T) toggle and turned on by default.
  136.  44.17 wrong displaymode for ehb pictures were chosen on rtg systems <Ulrich
  137.        Falke>.
  138.  44.18 CHIPBM option is a toggle (/T) now and turned on by default when 
  139.        there's no cgfx compatible api available. recompiled using egcs 1.1.
  140.  
  141.  
  142. SPECIAL THANKS GO TO ...
  143.  Matthias Scheler and
  144.  Frank Mariak for answering my questions concerning iff-ilbm
  145.  and CyberGFX.
  146.  Volker Remuss for his suggestions.
  147.  Allan Odgaard for the bug report.
  148.  Jens Rosenboom for his bug reports.
  149.  Gunther Nikl for his help with gcc and CreateHAMLine.c.
  150.  Michael Hendren, Alexander Niven-Jenkins, Trevor Daley and
  151.  Constantinos Nicolakakis for reporting the "p96 pictdt / ibrowse problem".
  152.  Olaf Barthel for his help.
  153.  
  154.  And to all other people who send me emails.
  155.  
  156.  
  157. AUTHOR
  158.  
  159.  Please send bug reports and ideas to:
  160.  
  161.     Stephan Rupprecht
  162.     Apfeldweg 1
  163.     D44359 Dortmund
  164.     Germany
  165.  
  166.  Send emails to
  167.  
  168.     stephan.rupprecht@gmx.de
  169.